Skip to content

Improve Quota Statement#10506

Open
julien-vaz wants to merge 13 commits intoapache:mainfrom
scclouds:improve-quota-statement
Open

Improve Quota Statement#10506
julien-vaz wants to merge 13 commits intoapache:mainfrom
scclouds:improve-quota-statement

Conversation

@julien-vaz
Copy link
Copy Markdown
Contributor

Description

In the current version, the quotaStatement API is returning the internal ID for account and domain, which is not useful for users, since all APIs use/return the UUID. Also, when the usage_type parameter is informed, the API shows dummy records.

To address those problems:

  • the API was modified so it returns the resources' UUID;
  • the dummy records bug was fixed;
  • a new parameter showresources was added to display more information to the user about each usage type;
  • a new quotaStatementDetails API was created to list more details about each usage type;

Types of changes

  • Breaking change (fix or feature that would cause existing functionality to change)
  • New feature (non-breaking change which adds functionality)
  • Bug fix (non-breaking change which fixes an issue)
  • Enhancement (improves an existing feature and functionality)
  • Cleanup (Code refactoring and cleanup, that may add test cases)
  • build/CI
  • test (unit or integration test code)

Feature/Enhancement Scale or Bug Severity

Feature/Enhancement Scale

  • Major
  • Minor

How Has This Been Tested?

On CloudMonkey the quotaStatement API was called and:

  • the resources' UUID was returned instead of the internal ID;
  • when specified a usage_type no dummy records were showed;
  • the showresources parameter is properly working;

The quotaStatementDetails API was called successfully as well.

@julien-vaz
Copy link
Copy Markdown
Contributor Author

@blueorangutan package

@blueorangutan
Copy link
Copy Markdown

@julien-vaz a [SL] Jenkins job has been kicked to build packages. It will be bundled with KVM, XenServer and VMware SystemVM templates. I'll keep you posted as I make progress.

@blueorangutan
Copy link
Copy Markdown

Packaging result [SF]: ✖️ el8 ✖️ el9 ✖️ debian ✖️ suse15. SL-JID 12669

@codecov
Copy link
Copy Markdown

codecov Bot commented Mar 5, 2025

Codecov Report

❌ Patch coverage is 21.37592% with 320 lines in your changes missing coverage. Please review.
✅ Project coverage is 18.02%. Comparing base (3166e64) to head (1f39686).
⚠️ Report is 5 commits behind head on main.

Files with missing lines Patch % Lines
...udstack/api/response/QuotaResponseBuilderImpl.java 31.61% 105 Missing and 1 partial ⚠️
...g/apache/cloudstack/quota/vo/QuotaUsageJoinVO.java 27.90% 62 Missing ⚠️
...he/cloudstack/quota/dao/QuotaUsageJoinDaoImpl.java 0.00% 37 Missing ⚠️
...apache/cloudstack/quota/vo/QuotaTariffUsageVO.java 0.00% 31 Missing ⚠️
...ache/cloudstack/quota/vo/QuotaUsageResourceVO.java 0.00% 27 Missing ⚠️
...ache/cloudstack/api/command/QuotaStatementCmd.java 15.78% 16 Missing ⚠️
.../cloudstack/quota/dao/QuotaTariffUsageDaoImpl.java 0.00% 15 Missing ⚠️
...i/response/QuotaStatementItemResourceResponse.java 0.00% 13 Missing ⚠️
...loudstack/api/response/QuotaStatementResponse.java 36.36% 7 Missing ⚠️
...c/main/java/com/cloud/utils/db/SearchCriteria.java 0.00% 4 Missing ⚠️
... and 1 more
Additional details and impacted files
@@             Coverage Diff              @@
##               main   #10506      +/-   ##
============================================
+ Coverage     18.01%   18.02%   +0.01%     
- Complexity    16607    16628      +21     
============================================
  Files          6029     6035       +6     
  Lines        542160   542444     +284     
  Branches      66451    66473      +22     
============================================
+ Hits          97682    97790     +108     
- Misses       433461   433642     +181     
+ Partials      11017    11012       -5     
Flag Coverage Δ
uitests 3.52% <ø> (ø)
unittests 19.18% <21.37%> (+0.01%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@winterhazel winterhazel self-requested a review March 6, 2025 13:06
@julien-vaz
Copy link
Copy Markdown
Contributor Author

@blueorangutan package

@blueorangutan
Copy link
Copy Markdown

@julien-vaz a [SL] Jenkins job has been kicked to build packages. It will be bundled with KVM, XenServer and VMware SystemVM templates. I'll keep you posted as I make progress.

@blueorangutan
Copy link
Copy Markdown

Packaging result [SF]: ✖️ el8 ✖️ el9 ✖️ debian ✖️ suse15. SL-JID 12689

@julien-vaz
Copy link
Copy Markdown
Contributor Author

I've just successfully builded the packages locally with -Dnoredist. Therefore, I'm requesting the package building again

@julien-vaz
Copy link
Copy Markdown
Contributor Author

@blueorangutan package

@blueorangutan
Copy link
Copy Markdown

@julien-vaz a [SL] Jenkins job has been kicked to build packages. It will be bundled with KVM, XenServer and VMware SystemVM templates. I'll keep you posted as I make progress.

@blueorangutan
Copy link
Copy Markdown

Packaging result [SF]: ✔️ el8 ✔️ el9 ✔️ debian ✔️ suse15. SL-JID 12742

Copy link
Copy Markdown
Contributor

@lucas-a-martins lucas-a-martins left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CLGTM

Copy link
Copy Markdown
Contributor

@DaanHoogland DaanHoogland left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

clgtm

@bernardodemarco bernardodemarco self-requested a review June 4, 2025 17:38
@sureshanaparti
Copy link
Copy Markdown
Contributor

@blueorangutan package

@blueorangutan
Copy link
Copy Markdown

@sureshanaparti a [SL] Jenkins job has been kicked to build packages. It will be bundled with KVM, XenServer and VMware SystemVM templates. I'll keep you posted as I make progress.

@winterhazel
Copy link
Copy Markdown
Member

Are schema changes missing here? Seeing some new VO classes but no corresponding SQL changes I can find

@shwstppr good catch, some schema changes are missing. I will add them.

@winterhazel
Copy link
Copy Markdown
Member

@blueorangutan package

@blueorangutan
Copy link
Copy Markdown

@winterhazel a [SL] Jenkins job has been kicked to build packages. It will be bundled with no SystemVM templates. I'll keep you posted as I make progress.

@blueorangutan
Copy link
Copy Markdown

Packaging result [SF]: ✔️ el8 ✔️ el9 ✔️ el10 ✔️ debian ✔️ suse15. SL-JID 17410

@github-actions
Copy link
Copy Markdown

This pull request has merge conflicts. Dear author, please fix the conflicts and sync your branch with the base branch.

@DaanHoogland
Copy link
Copy Markdown
Contributor

@blueorangutan package

@blueorangutan
Copy link
Copy Markdown

@DaanHoogland a [SL] Jenkins job has been kicked to build packages. It will be bundled with no SystemVM templates. I'll keep you posted as I make progress.

@blueorangutan
Copy link
Copy Markdown

Packaging result [SF]: ✔️ el8 ✔️ el9 ✔️ el10 ✔️ debian ✔️ suse15. SL-JID 17568

@winterhazel
Copy link
Copy Markdown
Member

@blueorangutan package

Copy link
Copy Markdown
Member

@winterhazel winterhazel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tested the API's parameters (account, accountid, domainid, enddate, projectid, showresources, startdate, type) for root admin, domain admin, and user accounts. In the tests, I validated that the API returned the expected response while performing correct permission checking. The same environment from #10505 (comment) was used.


Environment configuration

My environment had two domains: ROOT and d1.

MariaDB [cloud]> select uuid,name,path,parent from domain;
+--------------------------------------+------+------+--------+
| uuid                                 | name | path | parent |
+--------------------------------------+------+------+--------+
| de3f3dfb-f84b-11f0-8ace-32e0826870ba | ROOT | /    |   NULL |
| dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d | d1   | /d1/ |      1 |
+--------------------------------------+------+------+--------+

Each domain had a domain admin (dr for ROOT and d1 for d1) and a user account (ur for ROOT and u1 for d1). ROOT also had a project and the root admin.

MariaDB [cloud]> select uuid,account_name,domain_id,role_id from account;
+--------------------------------------+--------------------------+-----------+---------+
| uuid                                 | account_name             | domain_id | role_id |
+--------------------------------------+--------------------------+-----------+---------+
| f684aae8-f84b-11f0-8ace-32e0826870ba | system                   |         1 |       1 |
| f684da1a-f84b-11f0-8ace-32e0826870ba | admin                    |         1 |       1 |
| 17dfdcce-fd02-46d0-85ae-7de91fda634c | baremetal-system-account |         1 |       4 |
| aaba75a0-a575-41be-80e1-dbea14c10e51 | dr                       |         1 |       3 |
| feaffae2-7ba4-45dc-b46f-20ae86192685 | d1                       |         2 |       3 |
| 2f49212d-d6d5-437b-800d-a7bb4a8def4b | u1                       |         2 |       4 |
| b029e8b8-e539-4d1a-906d-3d4f2fb36b82 | ur                       |         1 |       4 |
| b14100c6-d9f6-450e-87a2-0833bb45e5f8 | PrjAcct-aa-1             |         1 |    NULL |
+--------------------------------------+--------------------------+-----------+---------+

Test 1 (user accounts)

  • startdate and enddate only: returns only the user account's own statement.

     (u1) 🐱 > quota statement startdate=2025-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.1714893,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 23.43302496,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2025-03-01T00:00:00-0300",
         "totalquota": 24.60451426
       }
     }
  • account: allows generating their own statement, but not the statement of other accounts.

     (u1) 🐱 > quota statement account=u1 domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.1714893,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 23.43302496,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 24.60451426
       }
     }
    
     (u1) 🐱 > quota statement account=d1 domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
     🙈 Error: (HTTP 531, error code 4365) Caller does not have permission to operate with provided resource.
  • accountid: allows generating their own statement, but not the statement of other accounts.

     (u1) 🐱 > quota statement accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.1714893,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 23.43302496,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 24.60451426
       }
     }
    
     (u1) 🐱 > quota statement accountid=aaba75a0-a575-41be-80e1-dbea14c10e51 startdate=2026-03-01 enddate=2027-03-02
     🙈 Error: (HTTP 531, error code 4365) Caller does not have permission to operate with provided resource.
  • domainid: only generates their own statement. Returns an error when specifying a domain they do not belong to.

     (u1) 🐱 > quota statement domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.1714893,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 23.43302496,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 24.60451426
       }
     }
    
     (u1) 🐱 > quota statement domainid=de3f3dfb-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02
     🙈 Error: (HTTP 531, error code 4365) Account Account [{"accountName":"u1","id":6,"uuid":"2f49212d-d6d5-437b-800d-a7bb4a8def4b"}] does not have permission to operate within domain id=de3f3dfb-f84b-11f0-8ace-32e0826870ba
  • showresources: lists the resources of each quota type in the period when set to true.

     (u1) 🐱 > quota statement startdate=2026-03-01 enddate=2027-03-02 showresources=true
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "VM-91c1a276-e8a9-4fe9-bf93-905d84428b9a",
     	    "quotaconsumed": 0,
     	    "removed": false,
     	    "resourceid": "91c1a276-e8a9-4fe9-bf93-905d84428b9a"
     	  }
     	],
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.1714893,
     	"resources": [
     	  {
     	    "displayname": "VM-91c1a276-e8a9-4fe9-bf93-905d84428b9a",
     	    "quotaconsumed": 1.1714893,
     	    "removed": false,
     	    "resourceid": "91c1a276-e8a9-4fe9-bf93-905d84428b9a"
     	  }
     	],
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"resources": [],
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"resources": [],
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"resources": [],
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "ROOT-9",
     	    "quotaconsumed": 0,
     	    "removed": false,
     	    "resourceid": "d32f9ae3-c088-4f14-a15e-d2dcb0e53e98"
     	  }
     	],
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"resources": [],
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"resources": [],
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"resources": [],
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"resources": [],
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"resources": [],
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"resources": [],
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "DefaultL2NetworkOffering",
     	    "quotaconsumed": 0,
     	    "removed": false,
     	    "resourceid": "d5090e0b-a8ec-4435-973f-8af355faaa25"
     	  }
     	],
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"resources": [],
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"resources": [],
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"resources": [],
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"resources": [],
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"resources": [],
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"resources": [],
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"resources": [],
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"resources": [],
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"resources": [],
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"resources": [],
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 23.43302496,
     	"resources": [
     	  {
     	    "displayname": "<untraceable>",
     	    "quotaconsumed": 23.43302496,
     	    "removed": false
     	  }
     	],
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"resources": [],
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 24.60451426
       }
     }
    
     (u1) 🐱 > quota statement startdate=2026-03-01 enddate=2027-03-02 showresources=false
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.1714893,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 23.43302496,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 24.60451426
       }
     }
  • type: filters the statement to only include usage records for the specified usage type.

     (u1) 🐱 > quota statement startdate=2026-03-01 enddate=2027-03-02 type=1
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }
    
     (u1) 🐱 > quota statement startdate=2026-03-01 enddate=2027-03-02 type=1 showresources=true
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "VM-91c1a276-e8a9-4fe9-bf93-905d84428b9a",
     	    "quotaconsumed": 0,
     	    "removed": false,
     	    "resourceid": "91c1a276-e8a9-4fe9-bf93-905d84428b9a"
     	  }
     	],
     	"type": 1,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }
  • projectid: user accounts can only obtain statements for projects they belong to.

     (u1) 🐱 > quota statement projectid=c1ce41c4-7b01-4386-8264-479db5ace0bc startdate=2026-03-01 enddate=2027-03-02
     🙈 Error: (HTTP 432, error code 9999) The API [quotaStatement] does not exist or is not available for this account/user in project [c1ce41c4-7b01-4386-8264-479db5ace0bc].
    
     (ur) 🐱 > quota statement projectid=c1ce41c4-7b01-4386-8264-479db5ace0bc startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "ur",
         "accountid": "b029e8b8-e539-4d1a-906d-3d4f2fb36b82",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 0,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 0,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }

Test 2 (domain admins)

  • startdate and enddate only: returns only their own statement.

     (d1) 🐱 > quota statement startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "d1",
         "accountid": "feaffae2-7ba4-45dc-b46f-20ae86192685",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 0.32591051,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 6.51882704,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 6.84473755
       }
     }
  • account: allows generating statements for accounts belonging to their domain, but not for accounts from other domains.

     (d1) 🐱 > quota statement account=u1 domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.93128489,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 45.14953752,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 47.08082241
       }
     }
    
     (d1) 🐱 > quota statement account=d1 domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "d1",
         "accountid": "feaffae2-7ba4-45dc-b46f-20ae86192685",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 0.32591051,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 6.51882704,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 6.84473755
       }
     }
    
     (d1) 🐱 > quota statement account=admin domainid=de3f3dfb-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02
     🙈 Error: (HTTP 531, error code 4365) Caller does not have permission to operate with provided resource
    
  • accountid: allows generating statements for accounts belonging to their domain, but not for accounts from other domains.

     (d1) 🐱 > quota statement accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.93128489,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 45.14953752,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 47.08082241
       }
     }
    
     (d1) 🐱 > quota statement accountid=feaffae2-7ba4-45dc-b46f-20ae86192685 startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "d1",
         "accountid": "feaffae2-7ba4-45dc-b46f-20ae86192685",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 0.32591051,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 6.51882704,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 6.84473755
       }
     }
    
     (d1) 🐱 > quota statement accountid=f684da1a-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02
     🙈 Error: (HTTP 531, error code 4365) Caller does not have permission to operate with provided resource.
  • domainid: allows generating statements for all accounts in their domain, but returns an error for domains outside their scope.

     (d1) 🐱 > quota statement domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 2.2571954,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 51.66836456,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 53.92555996
       }
     }
    
     (d1) 🐱 > quota statement domainid=de3f3dfb-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02
     🙈 Error: (HTTP 531, error code 4365) Account Account [{"accountName":"d1","id":5,"uuid":"feaffae2-7ba4-45dc-b46f-20ae86192685"}] does not have permission to operate within domain id=de3f3dfb-f84b-11f0-8ace-32e0826870ba
  • showresources: lists the resources of each quota type in the period when set to true.

     (d1) 🐱 > quota statement accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b startdate=2026-03-01 enddate=2027-03-02 showresources=true
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "VM-91c1a276-e8a9-4fe9-bf93-905d84428b9a",
     	    "quotaconsumed": 0,
     	    "removed": true,
     	    "resourceid": "91c1a276-e8a9-4fe9-bf93-905d84428b9a"
     	  }
     	],
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.93128489,
     	"resources": [
     	  {
     	    "displayname": "VM-91c1a276-e8a9-4fe9-bf93-905d84428b9a",
     	    "quotaconsumed": 1.93128489,
     	    "removed": true,
     	    "resourceid": "91c1a276-e8a9-4fe9-bf93-905d84428b9a"
     	  }
     	],
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"resources": [],
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"resources": [],
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"resources": [],
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "ROOT-9",
     	    "quotaconsumed": 0,
     	    "removed": true,
     	    "resourceid": "d32f9ae3-c088-4f14-a15e-d2dcb0e53e98"
     	  }
     	],
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"resources": [],
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"resources": [],
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"resources": [],
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"resources": [],
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"resources": [],
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"resources": [],
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "DefaultL2NetworkOffering",
     	    "quotaconsumed": 0,
     	    "removed": false,
     	    "resourceid": "d5090e0b-a8ec-4435-973f-8af355faaa25"
     	  }
     	],
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"resources": [],
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"resources": [],
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"resources": [],
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"resources": [],
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"resources": [],
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"resources": [],
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"resources": [],
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"resources": [],
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"resources": [],
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"resources": [],
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 45.14953752,
     	"resources": [
     	  {
     	    "displayname": "<untraceable>",
     	    "quotaconsumed": 45.14953752,
     	    "removed": false
     	  }
     	],
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"resources": [],
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 47.08082241
       }
     }
    
     (d1) 🐱 > quota statement accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b startdate=2026-03-01 enddate=2027-03-02 showresources=false
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.93128489,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 45.14953752,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 47.08082241
       }
     }
  • type: filters the statement to only include usage records for the specified usage type.

     (d1) 🐱 > quota statement accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b startdate=2026-03-01 enddate=2027-03-02 type=1
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }
    
     (d1) 🐱 > quota statement accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b startdate=2026-03-01 enddate=2027-03-02 type=1 showresources=true
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "VM-91c1a276-e8a9-4fe9-bf93-905d84428b9a",
     	    "quotaconsumed": 0,
     	    "removed": true,
     	    "resourceid": "91c1a276-e8a9-4fe9-bf93-905d84428b9a"
     	  }
     	],
     	"type": 1,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }
  • projectid: allows generating statements for projects belonging to their domain, but returns an error for projects outside it.

     (d1) 🐱 > quota statement projectid=c1ce41c4-7b01-4386-8264-479db5ace0bc startdate=2026-03-01 enddate=2027-03-02
     🙈 Error: (HTTP 531, error code 4365) Account Account [{"accountName":"d1","id":5,"uuid":"feaffae2-7ba4-45dc-b46f-20ae86192685"}] does not have permission to operate within domain id=de3f3dfb-f84b-11f0-8ace-32e0826870ba
    
     (dr) 🐱 > quota statement projectid=c1ce41c4-7b01-4386-8264-479db5ace0bc startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "PrjAcct-aa-1",
         "accountid": "b14100c6-d9f6-450e-87a2-0833bb45e5f8",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 0,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 0,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }

Test 3 (root admins)

  • startdate and enddate only: returns only their own statement.

     (admin) 🐱 > quota statement startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "admin",
         "accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 87.68817432,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 0,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 87.68817432
       }
     }
  • account: allows generating statements for all accounts.

     (admin) 🐱 > quota statement account=dr domainid=de3f3dfb-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "dr",
         "accountid": "aaba75a0-a575-41be-80e1-dbea14c10e51",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 0,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 0,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }
    
     (admin) 🐱 > quota statement account=u1 domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.93128489,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 45.14953752,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 47.08082241
       }
     }
  • accountid: allows generating statements for all accounts.

     (admin) 🐱 > quota statement accountid=f684da1a-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "admin",
         "accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 87.68817432,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 0,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 87.68817432
       }
     }
    
     (admin) 🐱 > quota statement accountid=b029e8b8-e539-4d1a-906d-3d4f2fb36b82 startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "ur",
         "accountid": "b029e8b8-e539-4d1a-906d-3d4f2fb36b82",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 0,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 0,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }
    
     (admin) 🐱 > quota statement accountid=feaffae2-7ba4-45dc-b46f-20ae86192685 startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "d1",
         "accountid": "feaffae2-7ba4-45dc-b46f-20ae86192685",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 0.32591051,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 6.51882704,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 6.84473755
       }
     }
    
     (admin) 🐱 > quota statement accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "u1",
         "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 1.93128489,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 45.14953752,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 47.08082241
       }
     }
  • domainid: allows generating statements for all domains.

     (admin) 🐱 > quota statement domainid=de3f3dfb-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 87.68817432,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 0,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 87.68817432
       }
     }
    
     (admin) 🐱 > quota statement domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 2.2571954,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 51.66836456,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 53.92555996
       }
     }
  • showresources: lists the resources of each quota type in the period when set to true.

     (admin) 🐱 > quota statement accountid=f684da1a-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02 showresources=true
     {
       "statement": {
         "account": "admin",
         "accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "VM-3fd7e901-8d9a-4b22-bc4a-df4145088535",
     	    "quotaconsumed": 0,
     	    "removed": false,
     	    "resourceid": "3fd7e901-8d9a-4b22-bc4a-df4145088535"
     	  }
     	],
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 87.68817432,
     	"resources": [
     	  {
     	    "displayname": "VM-3fd7e901-8d9a-4b22-bc4a-df4145088535",
     	    "quotaconsumed": 87.68817432,
     	    "removed": false,
     	    "resourceid": "3fd7e901-8d9a-4b22-bc4a-df4145088535"
     	  }
     	],
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"resources": [],
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"resources": [],
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"resources": [],
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"resources": [],
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"resources": [],
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"resources": [],
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"resources": [],
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"resources": [],
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"resources": [],
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"resources": [],
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "DefaultSharedNetworkOffering",
     	    "quotaconsumed": 0,
     	    "removed": false,
     	    "resourceid": "b7f878a4-b72b-4ae6-a496-2f8ccd5b98e4"
     	  }
     	],
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"resources": [],
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"resources": [],
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"resources": [],
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"resources": [],
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"resources": [],
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"resources": [],
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"resources": [],
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"resources": [],
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"resources": [],
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"resources": [],
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 0,
     	"resources": [],
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"resources": [],
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 87.68817432
       }
     }
    
     (admin) 🐱 > quota statement accountid=f684da1a-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02 showresources=false
     {
       "statement": {
         "account": "admin",
         "accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 87.68817432,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 0,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 87.68817432
       }
     }
  • type: filters the statement to only include usage records for the specified usage type.

     (admin) 🐱 > quota statement accountid=f684da1a-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02 type=1
     {
       "statement": {
         "account": "admin",
         "accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }
    
     (admin) 🐱 > quota statement accountid=f684da1a-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02 type=1 showresources=true
     {
       "statement": {
         "account": "admin",
         "accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"resources": [
     	  {
     	    "displayname": "VM-3fd7e901-8d9a-4b22-bc4a-df4145088535",
     	    "quotaconsumed": 0,
     	    "removed": false,
     	    "resourceid": "3fd7e901-8d9a-4b22-bc4a-df4145088535"
     	  }
     	],
     	"type": 1,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }
  • projectid: allows generating statements for all projects in the environment.

     (admin) 🐱 > quota statement projectid=c1ce41c4-7b01-4386-8264-479db5ace0bc startdate=2026-03-01 enddate=2027-03-02
     {
       "statement": {
         "account": "PrjAcct-aa-1",
         "accountid": "b14100c6-d9f6-450e-87a2-0833bb45e5f8",
         "currency": "$",
         "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [
           {
     	"name": "RUNNING_VM",
     	"quota": 0,
     	"type": 1,
     	"unit": "Compute*Month"
           },
           {
     	"name": "ALLOCATED_VM",
     	"quota": 0,
     	"type": 2,
     	"unit": "Compute*Month"
           },
           {
     	"name": "IP_ADDRESS",
     	"quota": 0,
     	"type": 3,
     	"unit": "IP*Month"
           },
           {
     	"name": "NETWORK_BYTES_SENT",
     	"quota": 0,
     	"type": 4,
     	"unit": "GB"
           },
           {
     	"name": "NETWORK_BYTES_RECEIVED",
     	"quota": 0,
     	"type": 5,
     	"unit": "GB"
           },
           {
     	"name": "VOLUME",
     	"quota": 0,
     	"type": 6,
     	"unit": "GB*Month"
           },
           {
     	"name": "TEMPLATE",
     	"quota": 0,
     	"type": 7,
     	"unit": "GB*Month"
           },
           {
     	"name": "ISO",
     	"quota": 0,
     	"type": 8,
     	"unit": "GB*Month"
           },
           {
     	"name": "SNAPSHOT",
     	"quota": 0,
     	"type": 9,
     	"unit": "GB*Month"
           },
           {
     	"name": "SECURITY_GROUP",
     	"quota": 0,
     	"type": 10,
     	"unit": "Policy*Month"
           },
           {
     	"name": "LOAD_BALANCER_POLICY",
     	"quota": 0,
     	"type": 11,
     	"unit": "Policy*Month"
           },
           {
     	"name": "PORT_FORWARDING_RULE",
     	"quota": 0,
     	"type": 12,
     	"unit": "Policy*Month"
           },
           {
     	"name": "NETWORK_OFFERING",
     	"quota": 0,
     	"type": 13,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VPN_USERS",
     	"quota": 0,
     	"type": 14,
     	"unit": "Policy*Month"
           },
           {
     	"name": "VM_DISK_IO_READ",
     	"quota": 0,
     	"type": 21,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_IO_WRITE",
     	"quota": 0,
     	"type": 22,
     	"unit": "IOPS"
           },
           {
     	"name": "VM_DISK_BYTES_READ",
     	"quota": 0,
     	"type": 23,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_DISK_BYTES_WRITE",
     	"quota": 0,
     	"type": 24,
     	"unit": "Bytes"
           },
           {
     	"name": "VM_SNAPSHOT",
     	"quota": 0,
     	"type": 25,
     	"unit": "GB*Month"
           },
           {
     	"name": "VOLUME_SECONDARY",
     	"quota": 0,
     	"type": 26,
     	"unit": "GB*Month"
           },
           {
     	"name": "VM_SNAPSHOT_ON_PRIMARY",
     	"quota": 0,
     	"type": 27,
     	"unit": "GB*Month"
           },
           {
     	"name": "BACKUP",
     	"quota": 0,
     	"type": 28,
     	"unit": "GB*Month"
           },
           {
     	"name": "BUCKET",
     	"quota": 0,
     	"type": 29,
     	"unit": "GB*Month"
           },
           {
     	"name": "NETWORK",
     	"quota": 0,
     	"type": 30,
     	"unit": "Compute*Month"
           },
           {
     	"name": "VPC",
     	"quota": 0,
     	"type": 31,
     	"unit": "Compute*Month"
           }
         ],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }
    
     (admin) 🐱 > quota statement projectid=3841cab4-e861-44a4-97e4-cb122ae9e7dd startdate=2026-03-01 enddate=2027-03-02 type=1
     {
       "statement": {
         "account": "PrjAcct-pd1-2",
         "accountid": "b8c5a156-193d-47b5-8dbc-c26e8a0a3ea3",
         "currency": "$",
         "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
         "enddate": "2027-03-02T23:59:59-0300",
         "quotausage": [],
         "startdate": "2026-03-01T00:00:00-0300",
         "totalquota": 0
       }
     }

@winterhazel
Copy link
Copy Markdown
Member

@blueorangutan package

@blueorangutan
Copy link
Copy Markdown

@winterhazel a [SL] Jenkins job has been kicked to build packages. It will be bundled with no SystemVM templates. I'll keep you posted as I make progress.

Copy link
Copy Markdown
Member

@bernardodemarco bernardodemarco left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

code lgtm, did not test it

@blueorangutan
Copy link
Copy Markdown

Packaging result [SF]: ✔️ el8 ✔️ el9 ✔️ el10 ✔️ debian ✔️ suse15. SL-JID 17592

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.